##############################################################################
###+---------+################################################################
#+-| I_STR() |---------------------------------------------------+############
#| +---------+ Converts the integer number to a character string |############
#+---------------------------------------------------------------+############
##############################################################################
##############################################################################
#+--| Summary |----------------+##############################################
#|     #INCLUDE string.hdr     |##############################################
#+-----------------------------+##############################################
##############################################################################
##############################################################################
#+--| Syntax |---------------------------+####################################
#|     FUNCTION CHAR i_str PROTOTYPE     |####################################
#|      PARAMETERS VALUE LONG number     |####################################
#+---------------------------------------+####################################
##############################################################################
##############################################################################
################+---| Description |-------------------------+#################
################| The i_str() function converts the integer |#################
################| number to a character string.             |#################
################+-------------------------------------------+#################
##############################################################################
##############################################################################
#########+---| Design |----------------------------------------------+########
#########| The i_str() function exists to allow the development of   |########
#########| "Warning-less" code.  The FORCE compiler issues a WARNING |########
#########| whenever a loss of precision occurs (e.g., going from a   |########
#########| double-precision number to an integer).  The WARNING      |########
#########| itself is harmless and exists to ALERT you to a condition |########
#########| which COULD be an error.  see error codes, for more       |########
#########| information.                                              |########
#########+-----------------------------------------------------------+########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Index on first name + employee number               |#########
#########|                                                          |#########
#########| INDEXDEF                                                 |#########
#########|     CHAR(20)  nameo  name->first+i_str(name->no)         |#########
#########| ENDDEF                                                   |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| *    Convert day of week, dow(), to a number to          |#########
#########| *    group items to be on sale.                          |#########
#########|                                                          |#########
#########| f_open( f, "group.txt", &F_APPEND )                      |#########
#########|                                                          |#########
#########| DO WHILE .NOT. eof()                                     |#########
#########|     f_putln( f, "Group: "+i_str(dow(q->date)) + ;        |#########
#########|                           q->descript )                  |#########
#########|     SKIP                                                 |#########
#########| ENDDO                                                    |#########
#########+----------------------------------------------------------+#########
##############################################################################